home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 401-425 / disk_415 / uedit / uedit-tutor < prev    next >
Text File  |  1992-05-06  |  34KB  |  844 lines

  1.  
  2.  
  3.                                 Uedit-Tutor
  4.                     Copyright (C) 1986-90, Rick Stiles
  5.  
  6.                  ((See Uedit-Policy for purchasing info.))
  7.  
  8.  
  9.                             **** DISCLAIMER ****
  10. I can accept no responsibility, if you crash your Amiga or lose text files
  11. with Uedit.  No guarantees, either explicit or implied, are made as to
  12. Uedit's safety.  If you use it, it is at your own risk.
  13.                             **** ********** ****
  14.  
  15. Dear folks,
  16.  
  17. (See Getting Started, below, for immediate instructions.)
  18.  
  19. Uedit is an editor for technical users.  It has many wordprocessing features.
  20.  
  21. In developing and enhancing Uedit, the aims have been for the user to:
  22.    o Be able to work without bumping into limits of power and capacity;
  23.    o Be able to automate repetitive work, eliminate tedium, save time;
  24.    o Be rid of the irritation of wasted keystrokes and stodgy performance;
  25.    o Be able to customize the environment fully;
  26.    o Be able to create, on the spot, new capabilities that are needed.
  27.  
  28. Uedit is Shareware.  You can get a copy from a friend or off a computer
  29. network and try it out, in order to decide whether to purchase the real thing
  30. or not.  (See Uedit-Policy for purchasing info.)
  31.  
  32.  
  33.                        *** About This Version ***
  34.  
  35. This freely distributable Shareware version has the following limitations
  36. in order to enable you to "get the flavor" and use Uedit productively and
  37. yet to encourage you to register to get the real thing:
  38.     1. It has a 4-file limit.  The stacks have been omitted, because of the
  39.        4-file limit.  If the stacks were included, you'd be able to edit an
  40.        "infinite" number of files (to limit of memory) and maintain an
  41.        arbitrary number of buffers and numbers on the stacks.
  42.     2. It will not let you save a full or partial configuration to disk.
  43.        Thus you can customize while you're using Uedit, create and compile
  44.        new commands, even compile an entire config file, but cannot save a
  45.        custom environment to disk for permanent use.
  46.     3. It won't let you save a learned sequence to disk.  You can use learn
  47.        mode as much as you want but cannot store the learned sequences for
  48.        permanent use.
  49.     4. The getBufAddr/attachBuf/detachBuf functions have been omitted, so
  50.        this version cannot exchange buffers with external programs or other
  51.        copies of Uedit running on your Amiga.
  52.  
  53.  
  54.                                About Uedit
  55.  
  56.  
  57. You can try Uedit immediately without reading beyond this paragraph.  The
  58. menus, HyperText Help, and Teach Mode should be enough for most users to get
  59. going.
  60.  
  61. When you use Teach Mode, be sure to try the shift/alt/ctrl/Amiga shift keys,
  62. to find out what the various combinations do with the keys and mouse-clicks
  63. and gadgets in the message line.  Abort out of Teach Mode with Amiga-ESC.
  64.  
  65. Goals in writing Uedit were openness, flexibility, power, friendliness -
  66. above all to give Freedom of Choice to the user.
  67.  
  68. Being able to edit 100 files (or more) is only the beginning of the depth
  69. Uedit has got.
  70.  
  71. Learn Mode adds a new dimension, providing instant automation for people who
  72. hate reading instructions and only want to know enough to get the job done.
  73.  
  74. The command language adds another dimension, letting you rewrite Every
  75. command, even the gadget and mouse button commands - on the fly.  Example:
  76. Put the cursor anywhere before the following command and press F6.
  77.              <normal-esc: putMsg("Welcome to Uedit!")
  78.                           alertUser("Click me") >
  79. Now press Esc.
  80.  
  81. Then there is the overall configurability and customizability, being able to
  82. swap and kill keys, change colors, customize the menus, etc.
  83.  
  84. Then there is the ability to switch configurations, changing the personality
  85. of Uedit in seconds, without interrupting editing.
  86.  
  87. Then there is the fact that it sleeps so that other tasks run efficiently and
  88. it can start other tasks and load in their results so that you can use them.
  89.  
  90. The ARexx interface allows you to send commands or text to Uedit from CLI or
  91. from host programs, thereby controlling Uedit from outside.  It allows Uedit
  92. to exchange data with ARexx host programs.
  93.  
  94. The "infinite" buffer and number stacks enable you to edit as many files or
  95. hold onto as many buffers or numbers as memory will hold.
  96.  
  97. Spooled file saving and spooled printing let you continue editing while
  98. saving and printing are in progress or when Uedit is in tiny window.
  99.  
  100. You can click the title bar and go to tiny window even during an operation,
  101. and the operation continues while in tiny window.
  102.  
  103. The spell-checking version of Uedit (see Uedit-Policy) allows you to spell-
  104. check documents, build dictionaries, create and use dictionary supplements,
  105. and so on.
  106.  
  107.                                  Features
  108.  
  109.  
  110. Uedit has too many features to go into here.  To name just a few, it has on-
  111. line Help facility as well as Teach Mode that teaches the purpose of keys,
  112. gadgets, clicks, and menu selections.
  113.  
  114. It has split windows, colored (hilite and invert) regions, interlace screen
  115. and RGB color tuning, mouse-scrolling and mouse cursor-placement, full sets
  116. of cut/copy/paste/clear capabilities for regular, inverted, or hilited as
  117. well as columnar text.
  118.  
  119. It lets you edit up to 100 or more files at once, has paragraph reformatting,
  120. page-making commands, printer selection and controls, undo-deletes, search-
  121. replace, edit-while-you-print up to 12 documents or regions, ctrl-click-
  122. loading of any filename anywhere, an interface that lets you use ARexx, and
  123. much more.
  124.  
  125. The main reason that Uedit's features can't be listed is that the user can
  126. create new ones anytime.
  127.  
  128. New commands can be typed into any buffer.  They are compiled in a fraction
  129. of a second typically, when you put the cursor in front of them and press f6.
  130. The command development and debugging work environment is extremely fast.
  131. New commands can be tested immediately after they have been written or
  132. changed.
  133.  
  134.                        Ignore the Technical Aspects
  135.  
  136. In order to discover how easy Uedit is to use productively, ignore
  137. anything technical in this tutorial for the moment.  Just use the program
  138. like you would any editor or wordprocessor.
  139.  
  140. Uedit was written for ordinary people, not for hackers, although it is true
  141. that most users are technical.  You don't need to memorize anything technical
  142. in order to do powerful and automatic things.
  143.  
  144. For instance, learn mode couldn't be simpler to use and it doesn't require
  145. any technical grasp or memorization.  Yet it offers benefits that rival those
  146. of the command language and overall customizability of the program.
  147.  
  148. Just try Uedit as an ordinary editor first, and see how you like it.
  149.  
  150. And remember:  Almost anything you don't like can be changed by the user.
  151.  
  152.  
  153.                               Getting Started
  154.  
  155.  
  156. Workbench and CLI:
  157.  
  158. You can run Uedit immediately in Workbench by clicking its icon.
  159.  
  160. You can run it immediately in CLI by typing "Run UES file1 file2 file3 etc".
  161.  
  162. To be able to run UES from any directory, run CLI and type the following:
  163.                 Copy    UES   C:
  164.                 Copy    NoName.info S:
  165.                 Copy    Data! S:
  166.                 Copy    Help! S:
  167.                 Copy    Key-Help S:
  168.  
  169.  
  170. Now you can run Uedit from any directory.  NoName.info must be in S:, if you
  171. are going to select "Make icons" so that Uedit will create file icons for
  172. you.  (You can create your own custom NoName.info icon, if you wish.)
  173.  
  174. Data! and Help! must either be in S: or in your current working directory.
  175.  
  176.  
  177. Here is what the key-prefixes mean in the menu selections:  S=Shift, A=Alt,
  178. C=Ctrl, L=leftAmiga, R=rightAmiga.  Keypad keys are abbreviated with "kp".
  179.  
  180.  
  181. If a menu selection says "L-0", it means that holding down the left Amiga key
  182. and pressing "0" will do the same thing as the menu entry.  If it says "SA-
  183. kp7", it means hold down Shift and Alt keys and press the 7 on the keypad.
  184.  
  185. Press Help or use HyperText as needed.  Select "Teach keys" to learn about
  186. Uedit's keys.  When finished with Teach Keys, press Amiga-ESC.  (HyperSample
  187. and HyperSample.tbl must be in the current directory to use HyperText.)
  188.  
  189. Amiga-ESC is Uedit's general purpose Abort key.  Use it to Abort any operation.
  190.  
  191. To slide Uedit's screen up/down, put the mouse at the far right of the title
  192. bar.
  193.  
  194. CLI command line:
  195.  
  196. The "Run UES" command line can have any number of file names in it, up to the
  197. maximum that you are configured to use.  (The Shareware UES program is
  198. wired for 4 files maximum.)
  199.  
  200. The following flags can be used in the CLI command line as well.  The flags
  201. must come BEFORE the file names in the command line.  Example:
  202.     Run UES -a0x0f0f0f0f -b12345678 -lMyLearnSeq -k300 -dDataFileName
  203.     -cConfigFileName file1 file2 file3 ....
  204.  
  205. The -a and -b flags initialize the global variables UserGlobalA and
  206. UserGlobalB.  The -l flag causes the learned sequence to be run after the
  207. files in the command line are loaded in.  The -k flag causes the key with the
  208. corresponding macro-number to be executed - after the files (if any) are
  209. loaded, and after the learned sequence (if any) is run.  The flags are
  210. handled in the following order:
  211.     -c config file is loaded and compiled, if named.
  212.     -d data file is loaded, if named & exists & -c flag not used.
  213.     The named files are loaded, if any.
  214.     -a and -b set the global user variables, if used.
  215.     -l runs the learned sequence, if named & exists.
  216.     -k runs the key, if named & exists.
  217.  
  218. The function keys, F1 thru F10, do the following (with no shift keys):
  219.  
  220.     F1 = next file
  221.     F2 = save file
  222.     F3 = close file
  223.     F4 = quit
  224.     F5 = swap next 2 commands
  225.     F6 = compile command following cursor
  226.     F7 = input search text and search fwd
  227.     F8 = input replace text
  228.     F9 = search fwd
  229.     F10 = replace & search fwd
  230.  
  231.  
  232. Files and buffers:  Uedit has 100 buffers, which can be used for holding
  233. documents and bits and pieces of text.  The lowest buffer numbers are used for
  234. holding documents.  Any number of buffers may also be stored on the buffer
  235. stack.  (The same is true of the number stack and the file-saving queue.)
  236.  
  237. How many files Uedit will let you load in is determined by the "Max files"
  238. menu selection.  (The Shareware UES is wired to 4 files max.)
  239.  
  240. Directories and Files:
  241.  
  242. The easiest way to load a file is to Ctrl-click its name in Uedit.  There are
  243. two "current" directories:
  244.  
  245.     One is the Current Directory in which the Uedit program is running.  This
  246.     is the directory you started up in, unless you change it.  (See AmigaDOS
  247.     menu.)
  248.  
  249.     The second is the click-loading directory that Uedit currently is using.
  250.     The default click-loading directory is also the directory you started up
  251.     in, but you can change it as described below.
  252.  
  253. If you ctrl-click a directory name such as myDir/ in any buffer, the
  254. directory name is added to the list of directories in buffer 38.  If you
  255. ctrl-click in whitespace in any buffer, a split window opens up showing
  256. you the directory list (buffer 38) with the current click-loading
  257. directory hilited.
  258.  
  259. In the split window (buffer 38), you can change the current directory, get a
  260. dir listing, edit or save the directory buffer, get the current directory
  261. (CD), or select a new click-loading directory.
  262.  
  263. You can also get a directory listing by selecting "Directory" in the menu.
  264. The directory name you give is put into the directory list and becomes the
  265. current click-loading directory.
  266.  
  267. The "Files" menu lets you load/insert/rename/restore/save/close files.
  268.  
  269. Miscellaneous:
  270.  
  271. To make the 4 invisible "gadgets" in the message line visible or invisible,
  272. press Ctrl-g.
  273.  
  274. To make the cursor page/row/column info visible or invisible, press ctl-2.
  275. (These are in the menus: "Mark gadgets" and "Row/Column".)
  276.  
  277.  
  278. Scrolling:  Scroll vertically by holding down the mouse button and moving the
  279. mouse.  The arrow keys also do vertical and horizontal scrolling.
  280.  
  281. For faster scrolls, either hold down the up/down arrow key or use Shift, Alt,
  282. or Ctrl with the arrow key.  For a slower scroll, use the up/down gadgets.
  283.  
  284.  
  285. Moving the Cursor:  Much of the time you may prefer placing the cursor by
  286. clicking the left mouse-button.
  287.  
  288. The keypad keys 2, 4, 6, & 8 move the cursor up/down/left/right by word/
  289. character/line/page depending on which shift key is used.
  290.  
  291. (Teach Keys will give you the sense of the keypad keys.)
  292.  
  293.  
  294. Scratch deletes & Undo:
  295.  
  296. Scratch deleting is what you'd normally use in meat & potatoes text work.  The
  297. following keys do scratch deletes at the cursor location:
  298.  
  299.     Ctrl-d deletes the cursor line.
  300.     Keypad-7 (unshifted) deletes word-left.
  301.     Keypad-9 (unshifted) deletes word-right.
  302.     Shift-kp7 deletes character left.
  303.     Shift-kp9 deletes the character under the cursor.
  304.     Alt-kp7 deletes to start of line.
  305.     Alt-kp9 deletes to end of line.
  306.     Ctrl-kp7 deletes to top of window.
  307.     Ctrl-kp9 deletes to bottom of window.
  308.  
  309. These are the "scratch" delete keys.  When you use them, the deleted material
  310. is stored in the scratch-delete (Undo) buffer.  Long as you don't move the
  311. cursor and make a delete somewhere else, you can store any number of scratch
  312. deletes.
  313.  
  314. Pressing keypad-0 inserts the Undo buffer at the cursor.  Thus, after doing a
  315. series of scratch deletes using the above keys, you can place the cursor
  316. somewhere, press keypad-0, and insert the deleted material.
  317.  
  318. If you move the cursor and do another scratch delete, the Undo buffer is
  319. cleared before the newly deleted text is stored.  You will find that you do
  320. most of your cut & paste the quick & dirty way, using scratch-deletes and the
  321. Undo key.
  322.  
  323.  
  324. If you select "Undo buffer" in the Split Window menu, you can monitor the
  325. contents of the Undo buffer and even type into it.  To adjust the size of any
  326. split window, activate the window by clicking it with the mouse and then
  327. press lAmiga-= and adjust the size by holding the left mouse-button and
  328. moving the mouse.
  329.  
  330. There can be up to 8 split windows in use.
  331.  
  332.  
  333. There are many ways to do cut/copy/paste operations with Uedit and to do them
  334. in parallel.
  335.  
  336. You can be doing cut & paste using scratch deletes, hilite region, invert
  337. region, and columnar data, all at the same time.  If these aren't enough,
  338. you've got 100 buffers to put bits and pieces into.  Any number of buffers
  339. can be put onto the stack using "Push buf", so you can maintain as many
  340. files and buffers as memory will hold.  (The Shareware UES program does
  341. not include the buffer & number stack functions.)
  342.  
  343.  
  344. Creating a hilite region:
  345.  
  346. There are 3 ways to mark a hilite region.  Press HELP and it will show them
  347. to you.
  348.  
  349. But rather than do that, try this:  Place the mouse high up in the text. 
  350. Hold down the Shift key and click the mouse.
  351.  
  352. Move the mouse to the lower right in the text.  Hold down the Alt key and
  353. click the mouse.
  354.  
  355. There should now be a hilited region.  This is one method of hiliting.
  356.  
  357.  
  358. Try this:  Select "Hilite buf" in the Split Window menu.  This shows you the
  359. contents of the copied hilite buffer.
  360.  
  361. Put the cursor anywhere in the colored, hilited region in the original buffer.
  362.  
  363. Now press keypad-Minus, the "-" key on the keypad.  This "cuts" the hilited
  364. region.  The region disappears.  (Don't move the cursor yet!)
  365.  
  366. Note that the cut material appeared instantly in the "Copied hilite" buffer.
  367.  
  368. Now press keypad-Enter.  This puts the "cut" text back where it was.  And it
  369. is hilited.  To unhilite it, press alt-h or select "Unhilite".
  370.  
  371.  
  372. To get rid of a split window, click the mousebutton in it, making it the
  373. active window-split.  Then select "Drop split" in the Split Window menu or
  374. press lAmiga-0.
  375.  
  376.  
  377. Columnar text operations:
  378.  
  379. Columnar regions are rectangular.  This means that when you create a hilite
  380. region to use for columnar text movement, the Start of the hilite region must
  381. be in a Lefthand column and the End of the hilite region must be in a
  382. Righthand column.  No region exists if the end of the region is not in a
  383. higher column number.
  384.  
  385.  
  386. Place the mouse high up in the text and to the left.  Press Shift and click
  387. the mousebutton.
  388.  
  389. Place the mouse low down and to the right, pointing to some word in the text.
  390. Press Alt and click the button.
  391.  
  392. Select "Col display" in the Edits menu.  Now the region should be displayed as
  393. rectangular.
  394.  
  395.  
  396. Select "Col copy" in the Columnar menu.  This makes a copy of the columnar
  397. region.
  398.  
  399. Put the cursor anywhere with the mouse.  Select "Col insert" in the Columnar
  400. menu and see what happens.
  401.  
  402. To remove the inserted, hilited columnar region, select "Col cut" in the menu.
  403.  
  404. (NOTE:  The keypad copy/cut/paste keys kpDot, kpMinus, and kpEnter also
  405. work as columnar keys when columnar display mode is used.)
  406.  
  407. You should experiment with columnar text in order to understand how to manage
  408. it.  (If you altered this Uedit-Tutor file just now, select "Restore" in the
  409. Files Open menu to restore it to the original.)
  410.  
  411.  
  412. When using columnar display mode, TABS are shown as "box" characters.  This is
  413. so that columns line up correctly when spaces and TABS are intermingled, as
  414. they often are.
  415.  
  416.  
  417. Tab Rulers:
  418.  
  419. There are 5 tab tables in Uedit, numbered 0 to 4.  You can change the tab
  420. table your document is using by selecting "Tab table" in the menu.
  421.  
  422. Individual documents can use different tab tables.  The tab ruler shows the
  423. tabs in the current document's tab table.
  424.  
  425. Select "See ruler" to see what the tab columns are or select "Set ruler" to
  426. set the tab columns.
  427.  
  428. If you have selected "Set ruler" and wish to set tabs at high columns beyond
  429. the right edge of the window, hold the mouse-button down and drag the mouse
  430. to the left, then release the button.
  431.  
  432. To slide the ruler to the right, drag the mouse rightward.
  433.  
  434. Tab columns can be set by clicking the mouse within 2 lines of the ruler, or
  435. by using the keys that the help message says to.
  436.  
  437.  
  438. Screens, colors, and RGB tuning:
  439.  
  440. The "Lace/Planes" submenu lets you select from 4 screens, which use 2 or 4
  441. colors, regular or interlace.  You can see the most lines of text by using
  442. an interlace screen.  Scrolling with the mouse is fastest when you use a
  443. regular 2 color screen.  Half as much memory is used when you use a 2
  444. color screen.
  445.  
  446. You can tune the RGB colors of Uedit's screen by selecting "Tune RGB";
  447. press ESC when you are finished with RGB tuning.  To rotate the 4 screen
  448. colors, press alt-HELP until you see a combination that you like.  Each
  449. buffer can use its own colors.  If you change the colors and want the menu
  450. colors updated, select "Do menus".
  451.  
  452.  
  453. Printing:
  454.  
  455. In the "Printing" menu, select "Print select" and put in a number 0 to 3,
  456. telling Uedit where you want your printing to go.  The message line tells you
  457. what the numbers 0-3 mean:
  458.     0 = raw text out the parallel port
  459.     1 = raw text out the serial port
  460.     2 = processed text using the Amiga's printer device
  461.     3 = raw text using the Amiga's printer device
  462.  
  463. If you embed Uedit's printer control codes in your text (such as for boldface,
  464. italics, etc) using the "Bracket hilite" or "Embed code" menu selections, you
  465. must set "Print select" to 2 or 3.
  466.  
  467. If you embed your own custom printer codes in the text, then you can use
  468. "Print select" values 0, 1, or 3, and they will be sent to your printer in raw
  469. form.  (Print-select value 2 allows the printer device to "strip out" any
  470. control codes that the Amiga printer device doesn't recognize.)
  471.  
  472.  
  473. (To embed CTRL characters, such as ESC, press ctl-c and then the desired
  474. character.  To identify any control character in the text, put the cursor on
  475. it and press ctl-/.)
  476.  
  477.  
  478. Print queue:  In the printing menu, you can select "Print hilite" or "Print
  479. file".
  480.  
  481. Long as the print-job will fit into memory, you can queue up as many as 12
  482. print-jobs and still go on editing while they print.
  483.  
  484.  
  485. You can even queue up print jobs to different printers, by changing "Print
  486. select" before selecting "Print hilite" or "Print file" for each print-job.
  487.  
  488. If the print-job is too big for memory, you will have to wait until printing
  489. is finished before you can continue editing.
  490.  
  491.  
  492. Save on idle:  By selecting "Save on idle" in the Local Modes menu, your file
  493. will be saved during pauses in your work, if it has been changed.
  494.  
  495. The length of the pause can be set by selecting "Idle timer".
  496.  
  497.  
  498. Margins, line-length, and lines-per-page:  In the Line/Page menu are
  499. selections for lines/page, line-length, top/bottom margins, and end-of-line.
  500.  
  501. If you want an "inner" left margin temporarily, simply indent the text and
  502. select "Autoindent", so that succeeding lines stay at the same indentation.
  503.  
  504.  
  505. To control the right margin, set line-length to the desired value.
  506.  
  507. If you set Left Margin in the Line/Page menu to any value greater than 0,
  508. typing will use the new left margin value.  Also, reformatting paragraphs will
  509. cause them to be reformated at the new left margin value.
  510.  
  511. Thus you can reformat an inset paragraph so that it is moved to the far left
  512. by setting Left Margin to 1 and reformatting it.
  513.  
  514.  
  515. Paragraph reformatting:  To reformat a paragraph, put the cursor in the line
  516. where you want reformatting to begin.  Then select "Paragraph" in the
  517. Reformats menu or press ctl-3.
  518.  
  519.  
  520. Paragraph reformatting ends when it reaches a blank line or a different
  521. indentation.  Different indentation says that you want a different left
  522. margin, hence it is not considered part of the paragraph being reformatted.
  523.  
  524.  
  525. Page formatting:  See the Paging menu.
  526.  
  527. Pages are determined by formfeeds in the text or by the line-count, using the
  528. current lines-per-page value.  To set the lines/page, see the Line-Page menu.
  529.  
  530.  
  531. The Page Formatting menu has selections for going to page#, going to top of
  532. page, gding to bottom of page, inserting a page-division, deleting the next
  533. page-division, and auto-inserting page-divisions in your entire document.
  534.  
  535. When a page-division is inserted, the page number is automatically put in.
  536.  
  537. You can erase the page number by selecting "Del page #".
  538.  
  539. Page numbers are put 1/2 the bottom margin distance from the bottom of the
  540. page, where the bottom of the page is simply the lines/page setting (normally
  541. 66).
  542.  
  543. (Note that these are all user-customizable commands which you can modify
  544. and recompile.  Every command in Uedit is customizable.)
  545.  
  546. When a page-division is inserted, the top margin for the next page is also put
  547. in, after deleting any blank lines.
  548.  
  549. The formfeed causes the display to draw a line across the window, making page
  550. divisions easy to locate visually.
  551.  
  552. You can find page divisions quickly by using the "Bottom page" and "Top page"
  553. menu selections.  (These are lAmiga-b and lAmiga-H.)
  554.  
  555. To insert a page-division and page number at the cursor, press lAmiga-v or
  556. select "Divide page".
  557.  
  558. To remove a page division, put the cursor anywhere in the page above the page
  559. division and press lAmiga-d or select "Del page div".
  560.  
  561.  
  562.                               Odds and Ends
  563.  
  564.  
  565. To abort any operation, press Amiga-ESC.
  566.  
  567. Primitive Mode is used for special text and number inputs.  The Title Bar and
  568. the message line tell you what to do in Primitive Mode.
  569.  
  570. If you press F7 to input a search string, you'll be in Primitive Mode.  Type
  571. in the search text, then press ESC or click the mousebutton to terminate the
  572. input.
  573.  
  574. In Primitive Mode, you can type in Ctrl characters (such as ctl-m for
  575. carriage return) directly.  No need to press ctl-c first.
  576.  
  577. You can change the Primitive Mode terminator character from ESC to some other
  578. Ctrl character (such as the Return key) by selecting "PM terminator" in the
  579. menu or by pressing ESC.
  580.  
  581.  
  582. You can search for two things at once by putting a "$" dollar sign between
  583. two search strings.  This is the eitherOr delimiter.  To cause searching
  584. to skip a particular pattern, use the "all-but" delimiter which is "~".
  585.  
  586. The "?" question mark is used by search as a single-character wildcard.  The
  587. "*" is used as a multi-character wildcard.
  588.  
  589. You can change these special characters by selecting "Wildcards" or
  590. "Either-or" in the "Settings" menu.
  591.  
  592. "Search case" toggles on/off the upper/lower case-sensitivity of searching.
  593.  
  594.  
  595. In the message line are fake "gadgets" (if "Mark Gadgets" is turned On),
  596. such as "Next file", "Prev file", and so on.
  597.  
  598. These message-line gadgets are just like keys and mouse clicks.  They can be
  599. swapped, killed, reprogrammed, learned, used in menu selections, and so on.
  600. Gadgets can be used with shift-keys, so there can be many more than 4 gadgets.
  601.  
  602.  
  603. Menu selections are always attached to a key, gadget or mouse-button command.
  604. If you swap a menu selection, the key you swapped it with is run when you
  605. select that menu item.
  606.  
  607.  
  608. Bookmarks:  The Shift gadget keys allow you to place up to 8 bookmarks in any
  609. buffer and goto the next or previous bookmark.
  610.  
  611. Grep:  Uedit has an enhanced grep, in addition to the normal search & replace
  612. capability.  The grep commands are the following:
  613.     lAmiga-f7:  set grep /search/replace/ string
  614.     lAmiga-f9:  grep search forward
  615.     rAmiga-f9:  grep search backward
  616.     lAmiga-f10: grep replace & search forward
  617.     rAmiga-f10: grep replace & search backward
  618.  
  619.  
  620. Uedit sleeps when it can, so that other tasks will run faster.
  621.  
  622.  
  623. Clicking the Title Bar switches to the tiny window.  The tiny window comes
  624. up inactive, so you can type into CLI immediately.
  625.  
  626. This also lets the Amiga reopen the big window in a better memory location.
  627.  
  628.  
  629. If Uedit runs out of memory and the "Memory..." message appears, that means it
  630. is compacting its stuff in memory, creating a larger area for the Amiga to use
  631. for graphics.  If "Memory..." appears, you ought to save and close some
  632. documents.  Also it's a good idea to click the Title Bar and reopen Uedit's
  633. window.
  634.  
  635.  
  636. Uedit sleeps between inputs.  If you don't type anything for 4 seconds, it
  637. does housekeeping.  If you select "Busies", you'll see which buffer is
  638. being worked on.  When the housekeeping is done, it sleeps.
  639.  
  640.  
  641. In the window's Title Bar, brackets [buf#,flags] contain the buffer number and
  642. various flags.  If Learn Mode is currently learning, "L#" appears, where #
  643. is the number of steps in the learned sequence.  If you are in Teach Mode,
  644. "T" appears.  If documents are queued up for printing, "P#" appears, where
  645. # is the number of print jobs yet to be done, up to 12 maximum.  If file-
  646. saves are in the queue, "S#" appears, where # is the file-saves remaining.
  647.  
  648.  
  649. Uedit picks up font changes made with Preferences or SetFont.  It speeds
  650. up the displaying of sized 8 and 11 fonts, such as Topaz 8, Clean 8, and
  651. Topaz 11, but it will let you use any font.  When you first start Uedit,
  652. it uses the font that Workbench is currently using.
  653.  
  654.  
  655. It works with all known hardware add-ons.  Some people start Uedit in
  656. their Workbench df0:S/Startup-Sequence and do everything from inside it. 
  657. They let it run other tasks and continue editing or let it sleep in tiny
  658. window while they work elsewhere.
  659.  
  660.  
  661. To see the current settings for line-length, lines/page, tab-table, margins,
  662. Uedit Serial Number, etc, press shift-HELP or select "Show vals".  This also
  663. shows you the size of the current file.
  664.  
  665.  
  666. Some settings are global and others are local to the current file.
  667.  
  668. Changing a local setting like word-wrap changes the global setting for future
  669. files loaded in.
  670.  
  671.  
  672. To recover the original configuration after fooling with commands, colors,
  673. etc, select "Load data".
  674.  
  675. After making any of the changes discussed here, selecting "Save data" will
  676. save all current settings to disk.  (Note:  Save Data is not included in
  677. the Shareware UES program.)
  678.  
  679.  
  680.                               Editing Tricks
  681.  
  682.  
  683. If you are like me and hate reading instructions, and expect programs to be
  684. Easy Without Reading, then Learn Mode is for you.
  685.  
  686. No reading is necessary.  Learn Mode uses just the normal editing stuff.
  687.  
  688. It offers immense power and capacity to automate tedious, repetitive jobs.
  689.  
  690. If you need to search and replace misspelled names in 300 documents, you can
  691. teach Learn Mode how to do one and let it do them all while you take a break.
  692.  
  693. To set up for such automation takes only as many seconds as it takes you to do
  694. one operation yourself, showing Learn Mode what to do.
  695.  
  696.  
  697. Simply press ctl-s to start Learn Mode, do the sequence of operations, and
  698. press ctl-r to end Learn Mode.  (If you press ctl-s a second time, it
  699. aborts and wipes out the learned sequence.)
  700.  
  701. Then press ctl-r to see how it works.  If you did it right and it works
  702. right, press ctl-m to set the command multiplier and then press ctl-r to run
  703. it as many times as desired.
  704.  
  705.  
  706. The Manual has lots of Examples and Editing Tricks which show how to take
  707. advantage of Uedit's versatility and power.  It describes how to use Learn
  708. Mode to click-add numbers or click-bracket words, do a mail-merge, and so
  709. on.
  710.  
  711.  
  712. A useful trick is to swap "Run learn" (ctl-r) with the mouse's buttonUp
  713. operation.  (A menu selection "Swap mouseUp" lets you do this swap.)
  714.  
  715. Then when you click the button, buttonDown will deposit the cursor like it
  716. normally does, and buttonUp will execute a learned sequence!
  717.  
  718.  
  719. The learned sequence can be anything.  It can, for instance, click-bracket
  720. text with printer control codes.  The Manual's Editing Tricks presents such
  721. examples.
  722.  
  723.  
  724. Or you can swap the mouse's buttonUp operation with another key, such as the
  725. add-numbers key (ctl-=).  Just select "Swap mouseUp" and press ctl-=.
  726.  
  727. Then you can click-add numbers that are scattered in various documents.
  728. Pressing ctl-\ will put the running total into the text at the cursor.
  729.  
  730.  
  731. Learned sequences can be stored on disk as files.  They are stored in your
  732. current directory.  If you copy them to S:, Uedit will find them from any
  733. directory.  The "Learn" menu lets you start, terminate, run, load, and save
  734. learned sequences.  (Note:  Save Learn is not included in the Shareware
  735. UES program.)
  736.  
  737. A saved learn sequence might, for example, go to top of document and type in
  738. a header, or go to bottom of document and type your name and address.  You
  739. could save it to disk and select "Load & run" in the Learn menu to run this
  740. learned sequence anytime.  You can assign a special key that inserts a
  741. header in one keystroke:
  742.  
  743.         <normal-esc: if (loadLearn("MyHeader")) runLearn >
  744.  
  745.  
  746.                             Config! and Data!
  747.  
  748.  
  749. Config! is a configuration file which is the Source of every command Uedit
  750. currently uses.  (Except, of course, you can customize Uedit while you're
  751. using it.)
  752.  
  753. A configuration may consist of a series of files.  The current standard
  754. config consists of:  Config!  (defaults and menu selections) Config!M
  755. (misc) Config!P (printing & paging) Config!R (ARexx) and Config!S
  756. (spelling & split windows)
  757.  
  758.  
  759. Data! is a compiled copy of Config! which Uedit loads at startup.
  760.  
  761. Data! should be in your S: directory or in your current directory, along with
  762. Help!, the help file.  If Data! is in S:, you can run Uedit from any directory
  763. or disk drive.  (Normally S: is assigned to the DF0:S subdirectory.  To
  764. assign it to myDirectory, type "Assign S: myDirectory" in CLI.)
  765.  
  766. To make Uedit recompile the config file, in CLI type:  Run Ues -c
  767.  
  768. The Config!(A-Z) have to be in your current directory or in S:.
  769.  
  770. You can keep as many config and data files on hand as you want.  The "Save
  771. data" and "Load data" selections in the menu let you switch configurations or
  772. save changes to Uedit that you have made while editing.  Thus you can
  773. customize it while using it.  (Save Data is not included in the Shareware
  774. UES program.)
  775.  
  776.  
  777. You can load and save data files from/to any directory and under any name.
  778. By customizing Uedit, you can turn it into an emulation of a favorite program
  779. or a disk utility or even possibly a spreadsheet.  While editing, you can
  780. select "Load data" and load in an entirely different configuration, changing
  781. its appearance and behavior.
  782.  
  783.  
  784. If you run Uedit by typing "Run UES -dDataFile .." or "Run UES -cConfigFile .."
  785. in CLI, it will load DataFile or compile ConfigFile.
  786.  
  787.  
  788. You can have hundreds of commands on-line at the same time.  Keys can load,
  789. compile, run, swap, and kill other keys, so there really is no limit to how
  790. many commands can be available at the press of a key.
  791.  
  792. Also you can create Partial Data files which contain blocks of commands that
  793. can be loaded in collectively or individually.  (Note:  The saveKeys()
  794. function is not included in the Shareware UES program, but loadKeys() is
  795. included.)
  796.  
  797.  
  798. There can be up to 7 menus with up to 20 selections each with up to 12 submenu
  799. selections, for a total of 1680 submenu selections.
  800.  
  801.  
  802. The configurability of Uedit is extreme.
  803.  
  804. A directory utility configuration was written that, in some respects, is more
  805. powerful and useful than directory utility programs typically are.  It lets
  806. you load in up to 100 or more directory listings and copy/delete/rename files
  807. and directories.  And while using it you can hold onto the files you were
  808. editing before you switched over to the dir-util config, as well as load in
  809. various files to read, edit, and save them while in the midst of directory
  810. house-cleaning.  This dir-util config is available as an extra.
  811.  
  812. Kurt Wessels wrote a config called UStar which emulates WordStar (tm) and
  813. Scribble! (tm).  Kurt's UStar is available as an extra.
  814.  
  815. Eric Kennedy wrote a VI! config which emulates the famous Unix(tm) vi editor.
  816. Unix users can feel right at home, using VI! instead of Uedit's standard
  817. configuration.  VI! is available as an extra.
  818.  
  819. Kent McPherson has written a Gold Key configuration that emulates the famous
  820. EDT Gold Key (tm) editor on DEC (tm) minicomputers.
  821.  
  822. Others have written specialized configs for programming and emulations of
  823. popular programs.  These are available as extras or from the authors or in
  824. the public domain.
  825.  
  826.  
  827.                              Acknowledgements
  828.  
  829.  
  830. I wish to thank the many users who have given thoughtful feedback on Uedit
  831. since it came out or have uploaded it to networks for me at their expense
  832. or helped in other generous ways.  Most of the improvements since V1.0
  833. have been because of their feedback, and Uedit's survival is due to the
  834. generous assistance of many users.  Used to be, I included a list here,
  835. but I simply had to take it out.  To name even one person or to try to
  836. name all who deserve it is sure to leave out somebody who really helped a
  837. lot.
  838.  
  839.                       *****************************
  840.  
  841.  
  842. Your feedback will be appreciated.
  843.  
  844.